Skip to content

Add url-card shortcode#1822

Merged
cderv merged 4 commits into
quarto-dev:mainfrom
multimeric:patch-1
Jun 22, 2026
Merged

Add url-card shortcode#1822
cderv merged 4 commits into
quarto-dev:mainfrom
multimeric:patch-1

Conversation

@multimeric

Copy link
Copy Markdown
Contributor

No description provided.

@cderv

cderv commented Oct 31, 2025

Copy link
Copy Markdown
Member

Thanks! The shortcode is called url-card but the extension seems to be named QuartoCards

We do list under extension names. An extension can have several shortcodes for examples.

Do you plan to rename or should we use repo name ?

@multimeric

multimeric commented Nov 1, 2025

Copy link
Copy Markdown
Contributor Author

Well I prefer QuartoCards as a repo name, in case I create more shortcodes. But I note there are a few repos like https://github.com/gadenbuie/quarto-partials and https://github.com/mcanouil/quarto-modal where the quarto- part is stripped off in the extensions page. This is what I was aiming for, because having Quarto in this list is a bit redundant. However, if your current policy is to not allow this, I might just rename the repo to quarto-cards to align with the style at least.

@cderv

cderv commented Nov 3, 2025

Copy link
Copy Markdown
Member

I create more shortcodes.

I meant that if you do add more shortcode to it, we wouldn't create a new entry I guess. Or at least for now we do list repo once.

Idea of this listing is to list the existing extensions and not each feature they have.

For the example you listed, the repo name is different but extension name is related

In your case we have title: QuartoCards in _extensions/QuartoCards/_extension.yml (source). So extensions is really QuartoCards when you install it.

Hence my initial questions. For us, this would be one extension in the listed that could offer multiple shortcode. Does this clarify my initial comment ?

But I can see why listing shortcode name instead of extension could be useful for search... 🤔

@cderv cderv left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For our current way to list, we prefer to list by extension name, so it would be QuartoCards.

Can I change it in the listing ? Do you want to rename ?

We may evolve in the future to have listing by shortcode of filter name, but for now this is by extension name.

Also you did not have a licence in your repo. Would be best to add one.

Thank you!

@multimeric

Copy link
Copy Markdown
Contributor Author

Okay, I've updated it to the extension name. Is it an issue that I'm PascalCase? Because I can rename the extension and repo to snake_case if that is preferable

@cderv

cderv commented Jun 22, 2026

Copy link
Copy Markdown
Member

I don't think it is . CLearly not the convention, but it will still install

Comment thread docs/extensions/listings/shortcodes-and-filters.yml
@cderv cderv merged commit 811f097 into quarto-dev:main Jun 22, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Successfully created backport PR for prerelease:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants